home *** CD-ROM | disk | FTP | other *** search
/ Alles Voor Internet / Tout Pour Internet / alles voor internet.iso / MacInternet™ / Modemtools / kermit tool gh 1.3 Folder / Read Me—Kermit Tool GH < prev   
Encoding:
Text File  |  1993-05-03  |  7.1 KB  |  154 lines  |  [TEXT/R*ch]
  1. Kermit Tool GH version 1.3
  2. by  Glenn R. Howes -- University of Wisconsin Department of Chemistry
  3. -------------------------------------------------------------------
  4. Notice: this will probably be the last version of this tool that 
  5. comes out for quite a long time. I'm sorry, but that's the way things
  6. go; hopefully, this version will give good service with most Kermit 
  7. implementations and will survive future system enhancements.
  8. -------------------------------------------------------------------
  9. changes since 1.2
  10.     • added method field so that the current method of transfer can
  11.       be seen (such as “Macbinary using CRC checking with 8th bit prefixing”).
  12.     • added a barber pole to give people something to look at when the 
  13.       remote Kermit doesn't send the tool the current file's length.
  14.     • added a data rate field (characters per second since negotiation).
  15.     • as a cute/semi-useful feature, system 7 users should now see the icons 
  16.       associated with the current contents of the file type fields.
  17.     • added an about box (brought up by hitting the balloon icon in the setup 
  18.       box).
  19.     • now try to fill up a classic (94 bytes) data packet has tightly as 
  20.       possible.
  21.     • will now try to explain why a transfer failed using the notification
  22.       alert box.
  23.     • moved the more esoteric parameters to their own dialog box
  24.       (accessible from the "Expert Options..." button).
  25.     • removed auto-receive.
  26.     • added the ability to specify separate characters for send and
  27.       receive start of packets.
  28.     • added a menu giving various options for modifying the filenames
  29.       sent out.
  30.     • removed support for an untested feature extra long packets (>9024)
  31.       as the current wisdom says that this is a useless feature.
  32.     • will warn the user if the attributes packet says the file is text
  33.       during a binary/macbinary transfer or vice versa. Doesn't do 
  34.       anything about it, but at least warns you.
  35. ---------------------------------------------------------------------
  36. What it is:
  37.  Kermit Tool GH is a freeware file transfer tool for use with  
  38.  programs that utilize the Macintosh Communications Toolbox.
  39.  Commercial and shareware developers must obtain a license to 
  40.  bundle this tool with their products.
  41.  
  42. How to use it:
  43.  1) Get a CTB compliant application. Examples would be ClarisWorks,
  44.  Termy,VersaTerm etc. 
  45.  2) Install the basic CTB set. (this is available from Apple).
  46.  3) Place Kermit Tool GH in either the extensions folder (sys 7) or
  47.  the communications folder (sys 6).
  48.  
  49. What it does:
  50.  Right now, it implements a Kermit file transfer protocal
  51.  with packet size <= 9024 (given enough memory); 1, 2 or 3 byte error 
  52.  checking; attribute packets; run compression; text, binary or 
  53.  macbinary file transfers.
  54.  In text mode it strips out line feeds while receiving and adds 
  55.  line feeds while transmitting. In macbinary mode it looks for a 
  56.  macbinary header so as to generate a mac-only file (such as an 
  57.  application).
  58.  
  59. Macbinary:
  60.  This tool supports the macbinary file format. If you want to only
  61.  use the current macbinary II format and not decode documents that
  62.  appear to be in macbinary I format you can check the appropriate box
  63.  in the setup dialog.(evidently certain file types such as the gif 
  64.  format can be misinterpreted as macbinary I). If a file being downloaded 
  65.  is determined to not have a valid macbinary header, it will be downloaded 
  66.  as a binary file with the type and creator chosen in the setup dialog. If a
  67.  file with a valid macbinary header is found to be incomplete: the
  68.  length data in the header is longer than the data actually received,
  69.  the file's type will be changed to 'BADD' and its creator to 'KerM',
  70.  with an appropriate icon. This was done to avoid generating
  71.  corrupt files which the finder thinks might be executable, but the
  72.  file will probably be useless anyway. 
  73.  
  74. Performance:
  75.  If you find that running this tool in the background is slowing 
  76.  down your machine too much, reduce the packet length. Alternatively,
  77.  if you want faster transfer speed increase the packet length
  78.  (1024 is a good value if the remote kermit supports it). I think my
  79.  implementation is quick compared to other implementations of Kermit.
  80.  Know that some minimal implementations of Kermit support packet 
  81.  lengths of 94 or less.
  82.  
  83. Tips:
  84.   The setup box has full balloon help. Please use it.
  85.   Make sure the receiving program is set to use the large packets
  86.  that you want.
  87.    Make sure that the remote computer is ready for binary files 
  88.  when you transfer binary or macbinary files. Text is usually the
  89.  default.
  90.    If a transfer stops dead, try cancelling and dropping the packet 
  91.  length, I find that a major reason that transfers fail is due
  92.  to problems with packets being too long, especially on sends.
  93.  There is a limit to this, don't drop below 80 byte packets.
  94.    Using run length compression (default) might give a noticeable
  95.  increase in throughput, especially for text files.
  96.    Use 8 bit lines if at all possible, especially for binary files.
  97.    If the remote Kermit doesn't accept a cancel command while sending,
  98.  try hitting Control-A followed by Return. If you do this 10 times 
  99.  in a row you should exceed the remote's retry limit.
  100.    When configuring the remote Kermit, try typing in "help" or "?",
  101.  many implementations will give you info on how to configure things
  102.  like packet-length.
  103.    There appears to be some sort of problem found when dealing with
  104.   older Kermits sending files to this tool. Every packet gets
  105.   echoed. I'm working on this, but sometimes waiting until the 
  106.   remote Kermit sends its first packet before starting receiving
  107.   works.
  108.  
  109. Testing:
  110.  I've had several people beta test this tool, they found several errors
  111.  and made many interface suggestions which I have incorporated into
  112.  this tools design. This does not mean there are no bugs, just that
  113.  I squashed the more obvious ones. 
  114.  
  115. Distribution:
  116.  Feel free to distribute this tool with this Read Me file. However, 
  117.  this tool is not to be sold or bundled with any shareware or 
  118.  commercial software without obtaining a license from me.
  119.  
  120. Legalisms:
  121.  I retain all rights to this tool and to its source code.
  122.  
  123.  I neither give nor imply any warranty of this product. Bugs are
  124.  unavoidable in software development, so any loss of data or
  125.  time caused by this tool is not my responsibility. Besides,
  126.  what did you pay for this tool. :-)
  127.  
  128. Thank You:
  129.   John Scott for rewriting the 'fcsr' segment in his own image
  130.   Brad Spencer and Ed Turner for lending me needed books
  131.   Frank da Cruz for writing "Kermit: A File Transfer Protocol"
  132.   Pete Resnick and John Rawnsley for their extra help in beta.
  133.   Symantec for selling a beautiful C compiler (Think C 5.0)
  134.   My mother for having me and 9 other children.
  135.  
  136. In the unlikely event you care:
  137.   My birthday is May 19th, and my favorite presents are cash,
  138.   shrink wrapped software and expensive computer equipment.
  139. -------------------------------------------------------------------
  140. If you find a serious bug, please catalog:
  141. how they occured,
  142. what equipment (computer),
  143. system software,
  144. application software,
  145. communication setup (parity, data bits, speed....),
  146. anything else that appears appropriate,
  147. your e-mail address if you have one
  148.  
  149. Glenn Howes
  150. Room #3211
  151. 1101 University Ave. 
  152. Madison,WI 53706
  153. howes@bert.chem.wisc.edu
  154.